اختبار Django في Python: TestCase vs. TransactionTestCase

الاختبار هو جانب حاسم في تطوير البرامج، مما يضمن أن تطبيقك يتصرف كما هو متوقع ويظل قويًا بمرور الوقت. يوفر Django، وهو إطار عمل ويب Python شائع، إطار اختبار قويًا لمساعدتك في كتابة اختبارات فعالة. ستتعمق منشور المدونة هذا في فئتين أساسيتين داخل إطار اختبار Django: TestCase و TransactionTestCase. سنستكشف اختلافاتهم وحالات استخدامهم ونقدم أمثلة عملية لمساعدتك في اختيار الفئة المناسبة لاحتياجات الاختبار الخاصة بك.

لماذا الاختبار مهم في Django

قبل الخوض في تفاصيل TestCase و TransactionTestCase، دعنا نناقش بإيجاز سبب أهمية الاختبار في تطوير Django:

• يضمن جودة التعليمات البرمجية: تساعدك الاختبارات على اكتشاف الأخطاء في وقت مبكر من عملية التطوير، مما يمنعها من الوصول إلى الإنتاج.
• يسهل إعادة البناء: مع مجموعة اختبار شاملة، يمكنك بثقة إعادة بناء التعليمات البرمجية الخاصة بك، مع العلم أن الاختبارات ستنبهك إذا قمت بإدخال أي تراجعات.
• يحسن التعاون: تعمل الاختبارات المكتوبة جيدًا كوثائق لتعليماتك البرمجية، مما يسهل على المطورين الآخرين فهمها والمساهمة فيها.
• يدعم التطوير القائم على الاختبار (TDD): TDD هو أسلوب تطوير حيث تكتب الاختبارات قبل كتابة التعليمات البرمجية الفعلية. يجبرك هذا على التفكير في السلوك المطلوب لتطبيقك مقدمًا، مما يؤدي إلى تعليمات برمجية أنظف وأكثر قابلية للصيانة.

إطار اختبار Django: نظرة عامة سريعة

تم بناء إطار اختبار Django على وحدة unittest المضمنة في Python. يوفر العديد من الميزات التي تجعل اختبار تطبيقات Django أسهل، بما في ذلك:

• اكتشاف الاختبار: يكتشف Django الاختبارات تلقائيًا ويشغلها داخل مشروعك.
• مشغل الاختبار: يوفر Django مشغل اختبار يقوم بتنفيذ اختباراتك والإبلاغ عن النتائج.
• طرق التأكيد: يوفر Django مجموعة من طرق التأكيد التي يمكنك استخدامها للتحقق من السلوك المتوقع لتعليماتك البرمجية.
• العميل: يتيح لك عميل اختبار Django محاكاة تفاعلات المستخدم مع تطبيقك، مثل إرسال النماذج أو إجراء طلبات API.
• TestCase و TransactionTestCase: هاتان هما الفئتان الأساسيتان لكتابة الاختبارات في Django، والتي سنستكشفها بالتفصيل.

TestCase: اختبار الوحدة السريع والفعال

TestCase هي الفئة الأساسية لكتابة اختبارات الوحدة في Django. يوفر بيئة قاعدة بيانات نظيفة لكل حالة اختبار، مما يضمن أن الاختبارات معزولة ولا تتداخل مع بعضها البعض.

كيف يعمل TestCase

عند استخدام TestCase، يقوم Django بتنفيذ الخطوات التالية لكل طريقة اختبار:

1. إنشاء قاعدة بيانات اختبار: يقوم Django بإنشاء قاعدة بيانات اختبار منفصلة لكل تشغيل اختبار.
2. مسح قاعدة البيانات: قبل كل طريقة اختبار، يقوم Django بمسح قاعدة بيانات الاختبار، وإزالة جميع البيانات الموجودة.
3. تشغيل طريقة الاختبار: يقوم Django بتنفيذ طريقة الاختبار التي حددتها.
4. التراجع عن المعاملة: بعد كل طريقة اختبار، يقوم Django بالتراجع عن المعاملة، مما يؤدي فعليًا إلى التراجع عن أي تغييرات تم إجراؤها على قاعدة البيانات أثناء الاختبار.

يضمن هذا النهج أن تبدأ كل طريقة اختبار بلوح نظيف وأن يتم عكس أي تغييرات يتم إجراؤها على قاعدة البيانات تلقائيًا. هذا يجعل TestCase مثاليًا لاختبار الوحدة، حيث تريد اختبار المكونات الفردية لتطبيقك في عزلة.

مثال: اختبار نموذج بسيط

دعونا نفكر في مثال بسيط لاختبار نموذج Django باستخدام TestCase:

from django.test import TestCase
from .models import Product

class ProductModelTest(TestCase):
 def test_product_creation(self):
 product = Product.objects.create(name="Test Product", price=10.00)
 self.assertEqual(product.name, "Test Product")
 self.assertEqual(product.price, 10.00)
 self.assertTrue(isinstance(product, Product))

في هذا المثال، نقوم باختبار إنشاء مثيل نموذج Product. تقوم طريقة test_product_creation بإنشاء منتج جديد ثم تستخدم طرق التأكيد للتحقق من أن سمات المنتج تم تعيينها بشكل صحيح.

متى تستخدم TestCase

TestCase هو عمومًا الخيار المفضل لمعظم سيناريوهات اختبار Django. إنه سريع وفعال ويوفر بيئة قاعدة بيانات نظيفة لكل اختبار. استخدم TestCase عندما:

• أنت تختبر النماذج أو طرق العرض أو المكونات الأخرى لتطبيقك.
• تريد التأكد من أن اختباراتك معزولة ولا تتداخل مع بعضها البعض.
• لست بحاجة إلى اختبار تفاعلات قاعدة البيانات المعقدة التي تمتد عبر معاملات متعددة.

TransactionTestCase: اختبار تفاعلات قاعدة البيانات المعقدة

TransactionTestCase هي فئة أخرى لكتابة الاختبارات في Django، لكنها تختلف عن TestCase في كيفية تعاملها مع معاملات قاعدة البيانات. بدلاً من التراجع عن المعاملة بعد كل طريقة اختبار، تقوم TransactionTestCase بتثبيت المعاملة. هذا يجعله مناسبًا لاختبار تفاعلات قاعدة البيانات المعقدة التي تمتد عبر معاملات متعددة، مثل تلك التي تتضمن إشارات أو معاملات ذرية.

كيف يعمل TransactionTestCase

عند استخدام TransactionTestCase، يقوم Django بتنفيذ الخطوات التالية لكل حالة اختبار:

1. إنشاء قاعدة بيانات اختبار: يقوم Django بإنشاء قاعدة بيانات اختبار منفصلة لكل تشغيل اختبار.
2. لا تقم بمسح قاعدة البيانات: TransactionTestCase *لا* يقوم تلقائيًا بمسح قاعدة البيانات قبل كل اختبار. يتوقع أن تكون قاعدة البيانات في حالة متسقة قبل تشغيل كل اختبار.
3. تشغيل طريقة الاختبار: يقوم Django بتنفيذ طريقة الاختبار التي حددتها.
4. تثبيت المعاملة: بعد كل طريقة اختبار، يقوم Django بتثبيت المعاملة، مما يجعل التغييرات دائمة في قاعدة بيانات الاختبار.
5. اقتطاع الجداول: في *نهاية* جميع الاختبارات في TransactionTestCase، يتم اقتطاع الجداول لمسح البيانات.

نظرًا لأن TransactionTestCase تقوم بتثبيت المعاملة بعد كل طريقة اختبار، فمن الضروري التأكد من أن اختباراتك لا تترك قاعدة البيانات في حالة غير متسقة. قد تحتاج إلى تنظيف أي بيانات تم إنشاؤها أثناء الاختبار يدويًا لتجنب التداخل مع الاختبارات اللاحقة.

مثال: اختبار الإشارات

دعونا نفكر في مثال لاختبار إشارات Django باستخدام TransactionTestCase:

from django.test import TransactionTestCase
from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import Product, ProductLog

@receiver(post_save, sender=Product)
def create_product_log(sender, instance, created, **kwargs):
 if created:
 ProductLog.objects.create(product=instance, action="Created")

class ProductSignalTest(TransactionTestCase):
def test_product_creation_signal(self):
 product = Product.objects.create(name="Test Product", price=10.00)
 self.assertEqual(ProductLog.objects.count(), 1)
 self.assertEqual(ProductLog.objects.first().product, product)
 self.assertEqual(ProductLog.objects.first().action, "Created")

في هذا المثال، نقوم باختبار إشارة تقوم بإنشاء مثيل ProductLog متى تم إنشاء مثيل Product جديد. تقوم طريقة test_product_creation_signal بإنشاء منتج جديد ثم تتحقق من إنشاء إدخال سجل منتج مطابق.

متى تستخدم TransactionTestCase

يتم استخدام TransactionTestCase عادةً في سيناريوهات محددة حيث تحتاج إلى اختبار تفاعلات قاعدة البيانات المعقدة التي تمتد عبر معاملات متعددة. ضع في اعتبارك استخدام TransactionTestCase عندما:

• أنت تختبر الإشارات التي يتم تشغيلها بواسطة عمليات قاعدة البيانات.
• أنت تختبر المعاملات الذرية التي تتضمن عمليات قاعدة بيانات متعددة.
• تحتاج إلى التحقق من حالة قاعدة البيانات بعد سلسلة من العمليات ذات الصلة.
• أنت تستخدم تعليمات برمجية تعتمد على المعرف المتزايد تلقائيًا للاستمرار بين الاختبارات (على الرغم من أن هذا يعتبر عمومًا ممارسة سيئة).

اعتبارات مهمة عند استخدام TransactionTestCase

نظرًا لأن TransactionTestCase تقوم بتثبيت المعاملات، فمن المهم أن تكون على دراية بالاعتبارات التالية:

• تنظيف قاعدة البيانات: قد تحتاج إلى تنظيف أي بيانات تم إنشاؤها أثناء الاختبار يدويًا لتجنب التداخل مع الاختبارات اللاحقة. ضع في اعتبارك استخدام طرق setUp و tearDown لإدارة بيانات الاختبار.
• عزل الاختبار: لا يوفر TransactionTestCase نفس مستوى عزل الاختبار مثل TestCase. كن على دراية بالتفاعلات المحتملة بين الاختبارات وتأكد من أن اختباراتك لا تعتمد على حالة قاعدة البيانات من الاختبارات السابقة.
• الأداء: يمكن أن يكون TransactionTestCase أبطأ من TestCase لأنه يتضمن تثبيت المعاملات. استخدمه بحكمة وعند الضرورة فقط.

أفضل الممارسات لاختبار Django

فيما يلي بعض أفضل الممارسات التي يجب وضعها في الاعتبار عند كتابة الاختبارات في Django:

• اكتب اختبارات واضحة وموجزة: يجب أن تكون الاختبارات سهلة الفهم والصيانة. استخدم أسماء وصفية لطرق وادعاءات الاختبار.
• اختبر شيئًا واحدًا في كل مرة: يجب أن تركز كل طريقة اختبار على اختبار جانب واحد من التعليمات البرمجية الخاصة بك. هذا يجعل من السهل تحديد مصدر الفشل عند فشل الاختبار.
• استخدم تأكيدات ذات معنى: استخدم طرق التأكيد التي تعبر بوضوح عن السلوك المتوقع لتعليماتك البرمجية. يوفر Django مجموعة غنية من طرق التأكيد لسيناريوهات مختلفة.
• اتبع نمط الترتيب والتمثيل والتأكيد: قم بهيكلة اختباراتك وفقًا لنمط الترتيب والتمثيل والتأكيد: قم بترتيب بيانات الاختبار، والعمل على التعليمات البرمجية قيد الاختبار، والتأكيد على النتيجة المتوقعة.
• حافظ على سرعة اختباراتك: يمكن أن تثبط الاختبارات البطيئة المطورين عن تشغيلها بشكل متكرر. قم بتحسين اختباراتك لتقليل وقت التنفيذ.
• استخدم التركيبات لبيانات الاختبار: التركيبات هي طريقة ملائمة لتحميل البيانات الأولية في قاعدة بيانات الاختبار الخاصة بك. استخدم التركيبات لإنشاء بيانات اختبار متسقة وقابلة لإعادة الاستخدام. ضع في اعتبارك استخدام المفاتيح الطبيعية في التركيبات لتجنب ترميز المعرفات.
• ضع في اعتبارك استخدام مكتبة اختبار مثل pytest: في حين أن إطار اختبار Django المضمن قوي، إلا أن المكتبات مثل pytest يمكن أن تقدم ميزات ومرونة إضافية.
• اسعَ لتحقيق تغطية اختبار عالية: استهدف تحقيق تغطية اختبار عالية لضمان اختبار التعليمات البرمجية الخاصة بك بدقة. استخدم أدوات التغطية لقياس تغطية الاختبار وتحديد المجالات التي تحتاج إلى مزيد من الاختبار.
• ادمج الاختبارات في خط أنابيب CI/CD الخاص بك: قم بتشغيل اختباراتك تلقائيًا كجزء من خط أنابيب التكامل المستمر والنشر المستمر (CI/CD). هذا يضمن اكتشاف أي تراجعات في وقت مبكر من عملية التطوير.
• اكتب اختبارات تعكس سيناريوهات العالم الحقيقي: اختبر تطبيقك بطرق تحاكي كيفية تفاعل المستخدمون معه بالفعل. سيساعدك هذا في الكشف عن الأخطاء التي قد لا تظهر في اختبارات الوحدة البسيطة. على سبيل المثال، ضع في اعتبارك الاختلافات في العناوين وأرقام الهواتف الدولية عند اختبار النماذج.

تدويل (i18n) والاختبار

عند تطوير تطبيقات Django لجمهور عالمي، من الضروري مراعاة التدويل (i18n) والترجمة (l10n). تأكد من أن اختباراتك تغطي لغات مختلفة وتنسيقات التاريخ ورموز العملات. فيما يلي بعض النصائح:

• الاختبار بإعدادات لغة مختلفة: استخدم زخرفة override_settings من Django لاختبار تطبيقك بإعدادات لغة مختلفة.
• استخدم البيانات المترجمة في اختباراتك: استخدم البيانات المترجمة في تركيبات الاختبار وطرق الاختبار الخاصة بك للتأكد من أن تطبيقك يتعامل مع تنسيقات التاريخ المختلفة ورموز العملات والبيانات الأخرى الخاصة بالإعدادات المحلية بشكل صحيح.
• اختبر سلاسل الترجمة الخاصة بك: تحقق من أن سلاسل الترجمة الخاصة بك مترجمة بشكل صحيح وأنها يتم عرضها بشكل صحيح بلغات مختلفة.
• استخدم علامة القالب localize: في قوالبك، استخدم علامة القالب localize لتنسيق التواريخ والأرقام والبيانات الأخرى الخاصة بالإعدادات المحلية وفقًا للإعدادات المحلية الحالية للمستخدم.

مثال: الاختبار بإعدادات لغة مختلفة

from django.test import TestCase
from django.utils import translation
from django.conf import settings

class InternationalizationTest(TestCase):

 def test_localized_date_format(self):
 original_language = translation.get_language()
 try:
 translation.activate('de') # Activate German language
 with self.settings(LANGUAGE_CODE='de'): # Set the language in settings
 from django.utils import formats
 from datetime import date
 d = date(2024, 1, 20)
 formatted_date = formats.date_format(d, 'SHORT_DATE_FORMAT')
 self.assertEqual(formatted_date, '20.01.2024')
 finally:
 translation.activate(original_language) # Restore original language

يوضح هذا المثال كيفية اختبار تنسيق التاريخ بإعدادات لغة مختلفة باستخدام وحدات translation و formats الخاصة بـ Django.

خاتمة

يعد فهم الاختلافات بين TestCase و TransactionTestCase أمرًا ضروريًا لكتابة اختبارات فعالة وموثوقة في Django. TestCase هو عمومًا الخيار المفضل لمعظم سيناريوهات الاختبار، مما يوفر طريقة سريعة وفعالة لاختبار المكونات الفردية لتطبيقك في عزلة. TransactionTestCase مفيد لاختبار تفاعلات قاعدة البيانات المعقدة التي تمتد عبر معاملات متعددة، مثل تلك التي تتضمن إشارات أو معاملات ذرية. من خلال اتباع أفضل الممارسات ومراعاة جوانب التدويل، يمكنك إنشاء مجموعة اختبار قوية تضمن جودة وقابلية صيانة تطبيقات Django الخاصة بك.

مزيد من التعلم

• وثائق اختبار Django
• وثائق وحدة اختبار Python
• وثائق pytest